home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / BIN2ASC.ZIP / B2A.DOC next >
Text File  |  1989-09-03  |  11KB  |  213 lines
  1.  
  2. ╔═════════════════════════════════════════════════════════════════════════════╗
  3. ║                                                                             ║
  4. ║                                                                             ║
  5. ║                                                                             ║
  6. ║                                  BIN2ASC.EXE                                ║
  7. ║                            DATA CONVERSION - Utility                        ║
  8. ║                                  User's Guide                               ║
  9. ║                                  Version 1.00                               ║
  10. ║                                Released 08/10/89                            ║
  11. ║                                                                             ║
  12. ║                           ==========================                        ║
  13. ║                                                                             ║
  14. ║                               Copyright (c) 1989                            ║
  15. ║                                 Carl F. Howard                              ║
  16. ║                               11321 Fairview St.                            ║
  17. ║                               El Monte, CA 91732                            ║
  18. ║                                                                             ║
  19. ║                      BIN2ASC.C Version 1.00 (c) Copyright 1989              ║
  20. ║                               ALL RIGHTS RESERVED                           ║
  21. ║                                                                             ║
  22. ║                                                                             ║
  23. ╚═════════════════════════════════════════════════════════════════════════════╝
  24.  
  25.  
  26.  BIN2ASC  is  the  copyrighted  property  of Carl F. Howard.  You are
  27.  granted a limited license  to  use  BIN2ASC,  and  to  copy  it  and
  28.  distribute it, provided that the following conditions are met:
  29.  
  30.  1)  You may not charge a fee for such copying and distribution.
  31.           
  32.  2)  You must distribute BIN2ASC as a complete set of files.
  33.           
  34.  3) You may ONLY distribute BIN2ASC in its original, unmodified state.
  35.           
  36.  This  program  is  being  distributed  under the Sharware concept
  37.  where users are urged to  distribute  this  program  in  original
  38.  form,  not  modified in any way, to their friends and other BBS's.
  39.  The  author  claims  no  responsibility  for  any  damage  either
  40.  accidental or otherwise through use of this program.  The program
  41.  is  provided  "AS  IS"  without  warranty  of  any  kind,  either
  42.  expressed or implied.  The entire risk  as  to  the  quality  and
  43.  compatibility of the program is with YOU.
  44.           
  45.  If  you use this program and find it of value,  any contributions
  46.  ($25 suggested) will be greatly appreciated and will  be  used  to
  47.  further develop useful software.  Send contributions to:
  48.           
  49.  Carl F. Howard
  50.  11321 Fairview St.
  51.  El Monte, CA 91732
  52.  
  53.  ============================================================================
  54.  
  55.                                   -------
  56.                                   BIN2ASC
  57.                                   -------
  58.  
  59.  
  60.  This Utility can be used to Port Data between different DB applications, by
  61.  converting binary formated (Byte Stream) data files to (ASCII) sdf files.
  62.  
  63.  The program reads each byte in the source file  and  translates non alpha-
  64.  numeric data to spaces ( ASCII Value=032 hex Value=20h ), not null's 000 or
  65.  00h. It is non-destructive. It does not change any data in the source file.
  66.  
  67.  All characters are are written to the target file, including spaces.  This
  68.  will maintain the record size integrity of the source file and the target
  69.  file will contain only printable ASCII characters. Note, after the specified
  70.  number of bytes for Record Size are written to the target file, a proper
  71.  MSDOS lf/cr  0Dh 0Ah sequence is  added to the end of each output line.
  72.  
  73.  To RUN:
  74.  
  75.  Copy BIN2ASC.EXE to any Directory listed in your DOS path and type BIN2ASC
  76.  at  the  DOS prompt.
  77.  
  78.  C>:BIN2ASC
  79.  
  80.  You will see an information screen describing the program and giving
  81.  brief instructions. Hit any key to exit the screen and continue the
  82.  program.
  83.  
  84.  A new Screen will then be presented prompting you for information about
  85.  the source and target files. Just enter the information prompted for by
  86.  the program.
  87.  
  88.  Note the following;
  89.  
  90.  1. You MUST specify the Input and Output File names.
  91.  
  92.     The files can be any leagal DOS name in any DOS directory.
  93.     If the target file exsist you will be prompted before overwriting it.
  94.     If you do not want to overwrite the target file type "n" at the prompt
  95.     and BIN2ASC will abort! Not graciously but you won't loose any data.
  96.  
  97.  2. YOU MUST specify an initial number of bytes to be Ignored when reading
  98.     the source file (  Note, you MUST Enter 0 if none  ). This will strip
  99.     header info and non-record data if it exsist at the begining of the
  100.     source file.
  101.  
  102.     This is neccessary since most data files contain some information about
  103.     the records contained in them, field names, types, size, and record
  104.     length  etc.
  105.  
  106.     BIN2ASC allows you to filter this information before records are written
  107.     to the target file so that is contains only DATA.
  108.  
  109.     Tip: If you don't know how many bytes preceed the actual data in the
  110.          file, use any file dump utility to examine the file and count the
  111.          number of characters you see that come before the data starts.
  112.          Enter this number when prompted.
  113.  
  114.  3. You MUST specify the record size (number of columns) for the Output File.
  115.  
  116.     Finally, you have to know how many bytes are contained in each record of
  117.     the source file. If you are converting from an exsisiting apllication and
  118.     have this information available it should be equal to the total number
  119.     of characters contained in all of the fields. dBase will indicate the
  120.     record lenth if you use the DISPLAY STRUCTURE command.
  121.  
  122.     Tip: The above method dosen't always work, your Data file may contain
  123.          characters in addition to the DATA, which are used to delimit
  124.          records. Here again it is advisable to Use a DUMP utilty to examine
  125.          the file and physicaly count the number of bytes between records.
  126.  
  127.    Once you have entered all of the above information the program will
  128.    execute. You will see a status screen indicating the job start time
  129.    and the number of records successfuly created. You may abort the
  130.    processing at any time by hitting any key while the records are being
  131.    created.  If you have aborted proccessing or the job has ended sucessfully
  132.    you will be presented with an EXIT screen indicating the total job time
  133.    and total number of records converted.
  134.  
  135.  
  136.  
  137. Technical Notes and other stuff! :
  138.  
  139. BIN2ASC was written using Microsoft Quick C version 2.0. The code is
  140. supposed to be compatible with other Microsoft C Compilers. It does
  141. use MSDOS specific functions for computing time but this could be
  142. easily modified for use with other operating systems.
  143.  
  144. You should be able to use this utility with any MSDOS or CP/M data
  145. file that stores information in ASCII form. If you are attempting
  146. to convert data from a main frame you will need to make sure that
  147. the source file has been translated from EBCIDIC to ASCII as this
  148. program does not make translations and assumes ASCII format.
  149.  
  150. SPEED! --  C HOW FAST!!!
  151.  
  152. This utility was developed and tested on a 12Mhz AT 0 wait Clone.
  153.                              
  154. This program was originaly written with Turbo Pascal Ver 3.00.
  155. Essentialy the same code, the PASCAL version took over 7 minutes and
  156. 30 seconds to convert 1489, 256 Byte records ( In A RAM DISK ). The
  157. C Version accomplishes the same task in 22 seconds. AWESUM! Do you
  158. think it would run any faster in assembly??
  159.  
  160. The manual states that Quick "C" compiler optimises code  for speed
  161. (Default mode, other options are available) and additionaly offers
  162. an option to decalre variables as (registers) types. Of course I
  163. used the register option <SMILE> which allows for direct manipulation
  164. of variables within the CPU as opposed to getting data from RAM.
  165.  
  166. Allthough C is more cryptic to program in it was well worth the time
  167. and effort to rewrite this program. If you've been thinking about
  168. upgrading from basic or and older version of PASCAL I can't say
  169. enough about Microsoft's Quick C version  of the language.  With the
  170. Instant online help features, sample programs, automated compiler and
  171. excellent manuals Microsoft has made getting up and running and writing
  172. code as painless as posible. (No they didn't pay me to say that!).
  173.  
  174. The source code for this utility is available to those of you who
  175. should desire it for a fee of $50.00. You may send a money order or
  176. personal check to the address indicated above. Your order will go out
  177. the next day or can be E-Mailed via GEnie.  You may leave E-mail to
  178. Carl.H on GEnie to report bugs or leave comments. Please note I will
  179. only offer technical assitance for registered users.
  180.  
  181. About the Author:
  182.  
  183. I am an exprienced dBase/Clipper programer and have written many
  184. applications for business and personal use in the (Clipper) language.
  185. I wrote the current version of the LIBMENU program used here on GEnie
  186. for viewing and searching GEnie IBM, DBFRT, FlagShip, Amiga, and
  187. Radio Rt's software library directories offline. I am also a SysOp in
  188. the FlagShip RT here on GEnie and check mail on a daily bases.
  189.  
  190. I do personal consulting and custom programing at reasonable rates. If
  191. you have a conversion problem or need to develop a custom application or
  192. just need technical advise leave me E-mail with your phone number and
  193. the nature of the help you need. I'll be glad give you a call to
  194. discuss your problem. Initial consultaions are free! Rates are $20.00
  195. an hour and/or special projects can be negotiated.
  196.  
  197. Finally, this program was written for friend to port a database of 5000
  198. plus records for a video rental store which was upgrading there harware
  199. from a CP/M-86 enviorment to MSDOS. The vendor that sold them the
  200. Hardware had initally quoted a price of $500.00 to convert the data, and
  201. latter raised that figure to $1,000. (after the hardware was sold). A
  202. rip off to say the least, but even at 20 cents a record (a resonable
  203. manual data entry rate) a price of $250.00 for just that one job  would
  204. not seem unfair. Considering that this program will convert a similar
  205. data file in under 2 minutes to a usable source data file suitable for
  206. importing into dBase the $25.00 I am asking is a real bargin. If you
  207. use this program for such commercial use a registration fee is expected!
  208.  
  209.  
  210.  
  211.        
  212.  
  213.